package cn.iocoder.yudao.module.promotion.service.channel;

import java.util.*;
import javax.validation.*;

import cn.iocoder.yudao.module.promotion.controller.admin.channel.vo.*;
import cn.iocoder.yudao.module.promotion.controller.app.channel.vo.ChannelLinkReqVO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.promotion.dal.dataobject.channel.ChannelLinkDO;

/**
 * 商城链接配置 Service 接口
 *
 * @author 超级管理员
 */
public interface ChannelLinkService {

    /**
     * 创建商城链接配置
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createChannelLink(@Valid ChannelLinkCreateReqVO createReqVO);

    /**
     * 更新商城链接配置
     *
     * @param updateReqVO 更新信息
     */
    void updateChannelLink(@Valid ChannelLinkUpdateReqVO updateReqVO);

    /**
     * 删除商城链接配置
     *
     * @param id 编号
     */
    void deleteChannelLink(Long id);

    /**
     * 获得商城链接配置
     *
     * @param id 编号
     * @return 商城链接配置
     */
    ChannelLinkDO getChannelLink(Long id);

    /**
     * 获得商城链接配置列表
     *
     * @param ids 编号
     * @return 商城链接配置列表
     */
    List<ChannelLinkDO> getChannelLinkList(Collection<Long> ids);

    /**
     * 获得商城链接配置分页
     *
     * @param pageReqVO 分页查询
     * @return 商城链接配置分页
     */
    PageResult<ChannelLinkDO> getChannelLinkPage(ChannelLinkPageReqVO pageReqVO);

    /**
     * 获得商城链接配置列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 商城链接配置列表
     */
    List<ChannelLinkDO> getChannelLinkList(ChannelLinkExportReqVO exportReqVO);

    /**
     * 关闭推广链接
     *
     * @param id 编号
     */
    void closeChannelLink(Long id);

    /**
     * 获得商城链接配置分页
     *
     * @param linkVO 查询
     * @return 商城链接配置
     */
    ChannelLinkDO getDetail(ChannelLinkReqVO linkVO);
}
